ARIA: aria-readonly-Attribut

Das aria-readonly-Attribut gibt an, dass das Element nicht bearbeitbar ist, aber dennoch bedienbar bleibt.

Beschreibung

Wenn Sie anzeigen möchten, dass ein interaktives Element funktioniert, aber nicht bearbeitbar ist, setzen Sie aria-readonly="true". Dies signalisiert dem Benutzer, dass ein interaktives Element, das normalerweise fokussierbar und kopierbar wäre, in einem schreibgeschützten (nicht deaktivierten) Zustand versetzt wurde.

Wenn aria-readonly auf true gesetzt ist, bedeutet dies, dass der Benutzer den Wert des Widgets lesen, aber nicht setzen kann. Schreibgeschützte Elemente sind für den Benutzer weiterhin relevant, daher sollten Sie nicht verhindern, dass der Benutzer zum Element oder seinen fokussierbaren Nachkommen navigiert oder den Wert kopiert.

Beispiele umfassen:

Formularelemente, die nicht geändert werden sollten.
Zeilen- und Spaltenüberschriften in einer Tabelle.
Der Gesamtwert in einem Einkaufswagen.

Wenn der nicht veränderbare Wert keinen Fokus erhalten sollte, verwenden Sie stattdessen aria-disabled.

Hinweis: Wenn Sie semantische HTML-Formularsteuerelemente verwenden und das readonly-Attribut setzen, müssen Sie aria-readonly="true" nicht hinzufügen.

Hinweis: Der Wert von <input type="checkbox"> kann nicht bearbeitet werden, was readonly irrelevant macht. Wenn jedoch Kontrollkästchen mit role="checkbox" erstellt werden, wird das aria-readonly-Attribut unterstützt.

Werte

true: Das Element ist schreibgeschützt.
false (Standard): Das Element ist nicht schreibgeschützt.

Zugehörige Schnittstellen

Element.ariaReadOnly: Die ariaReadOnly-Eigenschaft, Teil der Element-Schnittstelle, spiegelt den Wert des aria-readonly-Attributs wider.
ElementInternals.ariaReadOnly: Die ariaReadOnly-Eigenschaft, Teil der ElementInternals-Schnittstelle, spiegelt den Wert des aria-readonly-Attributs wider.

Zugehörige Rollen

Verwendet in Rollen:

Vererbt in Rollen:

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly